home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / bbs / plog403.zip / PWRLOGON.TXT < prev    next >
Text File  |  1996-07-04  |  16KB  |  405 lines
  1.  
  2.  
  3.  
  4.  
  5.         
  6.  
  7.         P O W E R    L O G O N            Version 4.03 for Wildcat! 5
  8.         _____________________________________________________________
  9.  
  10.         Logon Scripting Utility Developed by Crazy Larry's Online Art
  11.         503-357-2710   cloa@europa.com   http://www.europa.com/~cloa/
  12.         _____________________________________________________________
  13.  
  14.         
  15.  
  16.  
  17.  
  18.  
  19.                               TABLE OF CONTENTS
  20.  
  21.  
  22.  
  23.         Overview  . . . . . . . . . . . . . . . . . . . . . . . . . 2
  24.  
  25.         New Features  . . . . . . . . . . . . . . . . . . . . . . . 2
  26.  
  27.         Installation  . . . . . . . . . . . . . . . . . . . . . . . 3
  28.  
  29.         Editing Logon Scripts . . . . . . . . . . . . . . . . . . . 3
  30.  
  31.         Power Logon Commands  . . . . . . . . . . . . . . . . . . . 4
  32.  
  33.         Debugging/Troubleshooting . . . . . . . . . . . . . . . . . 6
  34.  
  35.         Packing List  . . . . . . . . . . . . . . . . . . . . . . . 6
  36.  
  37.         Shareware Notice  . . . . . . . . . . . . . . . . . . . . . 6
  38.  
  39.         Subscription Service  . . . . . . . . . . . . . . . . . . . 6
  40.  
  41.         Disclaimer  . . . . . . . . . . . . . . . . . . . . . . . . 7
  42.  
  43.  
  44.                         
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                                                Page 2
  61.  
  62.         OVERVIEW
  63.         _____________________________________________________________
  64.         Power Logon is essentially a "scripting utility"  that allows
  65.         you to fully control the  sequence of events that occurs when
  66.         a caller logs onto your BBS.  Separate scripts can be created
  67.         for each Access Profile, and/or for an individual user.
  68.  
  69.         With Power Logon,  it is  possible to arrange the sequence of
  70.         events by simply placing the commands in each script file, in
  71.         the order that you want them to be executed.
  72.  
  73.         Since user-specific scripts are available, you can offer your
  74.         callers a custom logon sequence as a bonus for subscribing to
  75.         your BBS, or as a separate service. 
  76.  
  77.         Some files included in the archive use long-file names, and
  78.         must be in the full, long-file-name format for Wildcat! to see
  79.         them.  I suggest using a program such as WinZip for Windows 95
  80.         to extract the files from the original archive.
  81.  
  82.  
  83.  
  84.  
  85.         NEW FEATURES
  86.         _____________________________________________________________
  87.         If you used Power Logon for Wildcat! v4.nn,  then you already
  88.         know how powerful, and useful this product is.  However there
  89.         have been several changes to this program  as a result of the
  90.         many changes in Wildcat! 5 and wcCode itself.
  91.  
  92.         Several of the commands have changed, and a few are no longer
  93.         supported. If you are upgrading, you should consider creating
  94.         all new configuration (script) files for this version.
  95.  
  96.         Power Logon now supports long-file-names supported by Win 95,
  97.         which makes things a lot easier for me <G>.  Now your scripts
  98.         are named according to the access profile, and user names.
  99.  
  100.         One of the best new features in Power Logon,  is the built-in
  101.         "Who Called Today" program!   Two commands are available that
  102.         allow you to add a callers name to this list, and display the
  103.         list.   This feature is disabled if neither of these commands
  104.         appear in any of your scripts.  For more information, see the
  105.         list of commands later in this documentation.
  106.  
  107.         You can also use the included program,  "List Who Called.WCX" 
  108.         to view the list of the days callers from any menu.  
  109.  
  110.         An additional file called "Navterm.wcx"  has also been added,  
  111.         and is used to include callers that use wcNavigator to access
  112.         your BBS, to the list of who called.   Wildcat! turns control
  113.         of the logon sequence  over to the  GUI side when a user logs
  114.         on to your BBS.   This means that the logon script will never
  115.         be used during logon. If Navterm.wcx is used, it will add the
  116.         callers name to the list of who called automatically.   Local
  117.         logons will not be recorded.
  118.  
  119.  
  120.                                                                Page 3
  121.  
  122.         INSTALLATION
  123.         _____________________________________________________________
  124.         To install or upgrade from a prior version of Power Logon:
  125.  
  126.         1]  Place all wcCode executable (*.WCX) files in your Wildcat
  127.             home directory.
  128.  
  129.         2]  Run wcMenu, and add the file "LOGONCFG.WCX" to your Sysop
  130.             Menu.  (Be sure to set  the access level for this program
  131.             so that you can use it).
  132.  
  133.         3]  If you plan to use the built-in Who Called Today feature,
  134.             you might want to add  the file "List Who Called.Wcx"  to
  135.             your Main, or any other menu before exiting wcMenu.
  136.  
  137.         4]  Save the changes to your menu, log onto your BBS, and run
  138.             the configuration program that you just installed.
  139.  
  140.         5]  If you registered Power Logon for Wildcat! 4, you need to
  141.             copy "PWRLOGON.KEY" from your old home directory to your
  142.             new \WC5\DATA subdirectory.
  143.  
  144.  
  145.         EDITING LOGON SCRIPTS
  146.         _____________________________________________________________
  147.         Logon scripts are simple text files that you can easily edit
  148.         offline using your favorite text editor.   The Configuration
  149.         program will launch Windows "Notepad" to edit them.
  150.  
  151.         When Power Logon starts, it looks for a user-specific script
  152.         file.   If one is not found,  it will then look for a script
  153.         that matches the users access level.   If this file does not
  154.         exist, it will look for the default LOGON.PLS.  If this file
  155.         is not available, it will execute the normal,  default logon
  156.         sequence that MSI hard-codes in Wildcat!
  157.  
  158.         Logon scripts can be as long as you want them, but they will
  159.         only be read up to the 100th line.   You can add comments in
  160.         your script files wherever you please, however, for the best
  161.         results, you should be aware of the following guidelines.
  162.  
  163.         1]  Comments should begin with a "<" character so that Power
  164.             Logon will recognize and ignore it.
  165.  
  166.         2]  Any text that does not start with the "<" character will
  167.             be treated as an instruction.  If the instruction is not
  168.             valid, Power Logon will ignore it, however, instructions
  169.             take time to proccess.
  170.  
  171.         3]  If you want to put comments next to your commands, it is
  172.             important that you put the command first,  followed by a
  173.             comment character (<) and the comment itself.
  174.  
  175.         4]  Adding blank lines will help to make your script files a
  176.             bit easier to read, and will be ignored entirely.
  177.  
  178.         5]  Commands are not case sensitive.
  179.  
  180.                                                                Page 4
  181.  
  182.         POWER LOGON COMMANDS
  183.         _____________________________________________________________
  184.  
  185.         Command         Description
  186.         ==============  =======================================
  187.         ADDTIME n       Adds "n" minutes to the callers time
  188.                         left for the day.
  189.  
  190.         ADDWHOCALLED    Adds the callers name to the built-in
  191.                         built-in "Who called today" list.
  192.  
  193.         ASKCHECKMAIL    Asks the caller if s/he would like to
  194.                         check his/her inbox.
  195.  
  196.         BEEP            Beeps the local and remote console
  197.  
  198.         BIRTHDAY        Displays the appropriate message if
  199.                         it is the callers birthday.
  200.                                                                                 
  201.         CHANGESETTINGS  Displays the "Your settings" menu to the
  202.                         caller.
  203.  
  204.         CHECKBULLETINS  Checks for updated bulletins, and prompts the
  205.                         user to view the Bulletin menu if any exist.
  206.                         
  207.         CHECKFASTLOGON  Exits the